Developer CD Series 1991 …esperately Seeking Seven/Desperately Seeking Seven.2mg/Dev.CD.8/Essentials/Tools/File.Type.Notes/FT.ABOUT.90.11

Text File | 1990-12-11 | 21.1 KB | 406 lines | [04] ASCII Text (0x0000)

Apple II
File Type Notes
_____________________________________________________________________________
                                                  Developer Technical Support


About Apple II File Type Notes                                  November 1990
_____________________________________________________________________________

This Note accompanies each release of Apple II File Type Notes.  This release
includes revised Notes for file type $E0, as well as an updated list of all
currently assigned Apple II file types and auxiliary types.

We welcome your file formats, suggestions on existing Notes, and yourrequests
for file type or auxiliary type assignments.  Please contact us at:

                    Apple II File Type Notes
                    Developer Technical Support
                    Apple Computer, Inc.
                    20525 Mariani Avenue, M/S 75-3T
                    Cupertino, CA  95014
                    AppleLink:  AIIDTS
                    MCI Mail:  AIIDTS (264-0103)
                    Internet:  [e-mail]

The universal sharing of file formats opens new dimensions to personal
computing, so we want Apple II File Type Notes distributed as widely as
possible.  We send them to all Partners and Associates at no charge, and we also
post them on AppleLink in the Developer Services bulletin board andother
electronic sources, including the Apple FTP site (IP 130.43.2.2).  You can also
order them through APDA.  As an APDA customer, you have access to the tools and
documentation necessary to develop Apple-compatible products.  For more
information about APDA, contact:

                    APDA
                    Apple Computer, Inc.
                    20525 Mariani Avenue, M/S 33-G
                    Cupertino, CA 95014
                    (800) 282-APDA or [phone]
                    Fax:  [phone]
                    Telex:  171-576
                    AppleLink:  APDA
                    Internet:  [e-mail]

We place no restrictions on copying the Notes, with the exception that you
cannot resell them.  You should note, however, that some of the file formats
are the copyrighted property of the companies which own them.  These formats
are identified in the appropriate Notes, and you should treat them with
respect to the applicable copyright laws.

All file type and auxiliary type combinations not listed in this Note are
reserved and must not be used by applications without assignment from Apple
Computer, Inc.


Specifically, you may not do the following:

  o  You may not use auxiliary type $0000 for a given file type instead
     of asking for an assignment.
  o  You may not use an auxiliary type in file type $BF, justifying it
     with, "My program runs under GS/OS and creates documents."
  o  You may not pick your own auxiliary type in a given file type and
     use it without getting an assignment from Apple.  You may request
     a specific auxiliary type if you desire, but you must be prepared
     for the instance in which your requested auxiliary type is not
     available.
  o  You may not redefine the auxiliary type of a file type to suit
     your own purposes.  For example, you can't choose to use auxiliary
     type $ABCD in file type $04, since the auxiliary type of file type
     $04 (text file) is already defined to be the record length of a
     random-access text file.

You may use file types and auxiliary types which are not assigned to you if a
complete definition of the contents of the file is published in File Type
Notes or elsewhere.  For example, you do not need to be assigned auxiliary
types to use text files or binary files.

If you have any questions at all about file type and auxiliary type policies,
assignments, or other specifics, do not hesitate to contact Developer
Technical Support at the address listed in this Note.

Developer Technical Support requires four things from a developer before
publishing a file format for your application in a File Type Note:

  1.  The file format itself, preferably in an ASCII text file.
  2.  Assurances that the product is shipping.  We don't want to jump
      the gun by releasing a Note for an unannounced product or a
      product which is unavailable.  The enclosed list of file type
      assignments includes only those products which we know are
      currently shipping.

Note:  If your product is shipping, but your file type is not
       listed, you need to contact DTS, since engineering uses this
       list to identify files in future Apple products, such as
       future releases of the Apple IIgs Finder.  If this Note does
       not list your file type and auxiliary type assignments,
       engineering cannot include them in future products.  The
       "short" names listed in this Note are used as the
       descriptors for such files, so you should contact DTS if a
       descriptor for one of your files is unsuitable.

       You must inform DTS when the program using your file type
       assignments ships to be included in future versions of the
       system software, even if you do not wish the file format to
       be published.

  3.  Written permission to publish the file format.  We don't want you
      to submit the format and then be surprised when we publish it.
  4.  Your company name and address, so we can refer readers to you for
      more information about your product.



Definitions

The following definitions apply to all Apple II File Type Notes and will not
be repeated in each Note:

Boolean        A binary indicator stored as a word unless otherwise
               indicated.  If any bit of a boolean is set, the boolean is
TRUE.          If it is clear, it is FALSE.
Byte           An 8-bit value.
Double Long    A 64-bit value, composed of eight byte, four words or two
               long words.  The most significant byte is stored last.
Fixed          A four-byte signed value where the least significant word
               represents a fractional part and the most significant word
               represents an integer part (i.e., the value 32767.0 would be
               stored as $00 $00 $FF $7F to represent the integer part of
               $7FFF (+32767) and the fractional part of $0000 (0)).  The
               value 4.5 would be stored as $00 $80 $04 $00 to represent
               the integer part of $0004 and the fractional part of $8000.
               The value $8000 is represented as 1000000000000000 in
               binary.  The bit immediately following the decimal point is
               set, which indicates the value of 2^-1, or one-half.  The
               full binary expansion of 4.5 is
               0000000000000100.1000000000000000, which indicates
               2^2 + 2^-1 or 4 + 0.5, which is 4.5.  The Apple IIgs
               Integer Math Tools contain routines to assist with
               Fixed arithmetic.
Flag unit      Any storage unit (byte, word, long) treated as a series of
               flag bits rather than as a numeric value.
Long           A 32-bit value, composed of four bytes or two words.  The
               most significant byte is stored last.  For example,
               $00E102A8 would be stored as $A8 $02 $E1 $00.
Reverse        The 65xxx series microprocessors normally store values with
               the least significant byte (LSB) first, while other
               microprocessors may store values with the most significant
               byte (MSB) first.  The designation Reverse (Rev.) indicates
               that values must be rearranged before using them  (i.e., a
               Long value of $11223344 would be stored as $44 $33 $22 $11,
               but a Reverse Long value would be stored as $11 $22 $33 $44).
String         A Pascal-type string.  It consists of a length byte followed
               by up to 255 bytes of ASCII data.
Word           A 16-bit value, composed of two bytes.  The most significant
               byte of the word is stored after the least significant byte.
               For example, $02FF would be stored $FF $02.

All bit definitions are given as bit numbers.  Bit 0 is always the least
significant bit.  The most significant bit of a byte is bit 7; the most
significant bit of a word is bit 15, etc.

Following is a current list of all file type and auxiliary type assignments.
Assignments with a date indicate the release date of the File Type Note for
that assignment, and all file types and auxiliary types which are not listed
in this Note are reserved and should not be used.

Although Apple strongly recommends the use of file type descriptors, this
document includes a list of three-letter abbreviations solely for developer
convenience.  These abbreviations are final as documented and will not be
changed.

_____________________________________________________________________________

File Type Assignments                                           November 1990

* = Finder identifies for System Software 5.0                         New ***
+ = Finder identifies for System Software 5.0 only on machines    Revised *R*
    with more than 512K memory


File Aux.   3Ltr File Type Description
Type Type   Abv  (File Type Owner)           Auxiliary Type Description  Date
$00*        UNK  Unknown                                                03/90
$01*        BAD  Bad blocks                                             03/90
$02+        PCD  Apple /// Pascal code
$03+        PTX  Apple /// Pascal text
$04*        TXT  ASCII text                  Random-access record-length
$05+        PDA  Apple /// Pascal data
$06*        BIN  Binary                      Load address in bank 0
$07+        FNT  Apple /// Font
$08*        FOT  Apple II or /// Graphics                               05/89
$08+ $4000       Packed Hi-Res Image         Image Format               11/88
$08+ $4001       Packed Double Hi-Res Image  Image Format               11/88
$09+        BA3  Apple /// BASIC program
$0A+        DA3  Apple /// BASIC data
$0B+        WPF  Apple /// Word Processor
$0C+        SOS  Apple /// SOS System
$0F*        DIR  Folder
$10+        RPD  Apple /// RPS data
$11+        RPI  Apple /// RPS index
$12+        AFD  Apple /// AppleFile discard
$13+        AFM  Apple /// AppleFile model
$14+        AFR  Apple /// AppleFile report format
$15+        SCL  Apple /// screen library
$16+        PFS  PFS document
$16+ $0001       PFS:File document           Program Specific
$16+ $0002       PFS:Write document          Program Specific
$16+ $0003       PFS:Graph document          Program Specific
$16+ $0004       PFS:Plan document           Program Specific
$16+ $0016       PFS internal data           Program Specific
$19* ADB         AppleWorks Data Base        Upper-/lowercase in name   07/90
$1A*        AWP  AppleWorks Word Processor   Upper-/lowercase in name   09/89
$1B*        ASP  AppleWorks Spreadsheet      Upper-/lowercase in name   09/89
$20+        TDM  Desktop Manager document
$21              Instant Pascal source
$22              UCSD Pascal Volume
$29+             Apple /// SOS Dictionary
$2A+        8SC  Apple II Source Code        Application Specific
$2B+        8OB  Apple II Object Code        Application Specific
$2B              GBBS Pro object Code        Application Specific
$2C+        8IC  Apple II Interpreted Code   Application Specific
$2C  $8003       APEX Program File           Application Specific
$2D+        8LD  Apple II Language Data      Application Specific
$2E         P8C  ProDOS 8 code module        Application Specific
$2E  $8002       Point-to-Point drivers      Application Specific
$2E  $8003       Point-to-Point code         Application Specific
$41              OCR data                    Application Specific
$42*        FTD  File Type Names             Search order               07/89
$50*        GWP  Apple IIGS Word Processor
$50  $5445       Teach                       Application Specific       03/90
$50+ $8001       DeluxeWrite document        Application Specific
$50+ $8010       AppleWorks GS Word          Application Specific    *R*09/90
                 Processor
$51*        GSS  Apple IIGS Spreadsheet
$51+ $8010       AppleWorks GS Spreadsheet   Application Specific
$52*        GDB  Apple IIGS Data Base
$52+ $8010       AppleWorks GS Data Base     Application Specific
$52+ $8011       AppleWorks GS DB Template   Application Specific
$53*        DRW  Drawing
$53  $8002       Graphic Disk Labeler        Application Specific       03/90
                 document
$53+ $8010       AppleWorks GS Graphics      Application Specific
$54*        GDP  Desktop Publishing
$54+ $8010       AppleWorks GS Page Layout   Application Specific
$54+ $DD3E       Medley document             Application Specific       05/89
$55*        HMD  Hypermedia                  Application Specific
$55+ $8001       Tutor-Tech document         Application Specific
$55+ $8002       HyperStudio document        Application Specific
$55  $8003       Nexus document              Application Specific
$56*        EDU  Educational Data            Application Specific
$56+ $8001       Tutor-Tech Scores           Application Specific
$57*        STN  Stationery
$58*        HLP  Help File
$59*        COM  Communications File         Application Specific
$59+ $8010       AppleWorks GS               Application Specific
                 Communications
$5A*        CFG  Configuration file          Application Specific
$5A  $0002       Battery RAM configuration                              05/90
$5A  $0003       AutoLaunch preferences      Application Specific
$5A+ $8001       Master Tracks Jr. preferences
$5A  $8003       Z-Link configuration        Application Specific
$5A  $8004       JumpStart configuration     Application Specific
$5A  $8009  PTP  Point-to-Point preferences
$5A  $800A       ORCA/Disassembler preferences
$5A+ $8010       AppleWorks GS               Application Specific
                 configuration
$5A  $8011       SDE Shell preferences       Application Specific
$5A  $8012       SDE Editor preferences      Application Specific
$5A  $8013       SDE system tab ruler        Application Specific
$5A  $8014       Nexus configuration         Application Specific
$5A  $8015       DesignMaster preferences    Application Specific
$5B*        ANM  Animation file              Application Specific
$5B+ $8001       Cartooners movie            Application Specific
$5B+ $8002       Cartooners actors           Application Specific
$5C         MUM  Multimedia document         Application Specific
$5D         ENT  Game/Entertainment          Application Specific
                 document
$5D   $8002      BattleFront scenario        Application Specific
$5D   $8003      BattleFront saved game      Application Specific
$5E         DVU  Development utility         Application Specific
                 document
$5E  $0001       Resource file                                          05/90
$5E  $8001       ORCA/Disassembler template  Application Specific
$5E  $8003       DesignMaster document       Application Specific
$6B+        BIO  PC Transporter BIOS
$6D+        TDR  PC Transporter driver
$6E+        PRE  PC Transporter pre-boot
$6F+        HDV  PC Transporter volume
$A0*        WP   WordPerfect document        WordPerfect                01/89
$AB+        GSB  Apple IIGS BASIC program
$AC+        TDF  Apple IIGS BASIC TDF
$AD+        BDF  Apple IIGS BASIC data
$B0*        SRC  Apple IIGS  source code     APW Language type          07/90
$B0+ $0001       APW Text file
$B0+ $0003       APW 65816 Assembly source code
$B0+ $0005       ORCA/Pascal source code
$B0+ $0006       APW command file
$B0+ $0008       ORCA/C source code
$B0+ $0009       APW Linker command file
$B0+ $000A       APW C source code
$B0+ $000C       ORCA/Desktop command file
$B0+ $0015       APW Rez source file
$B0+ $001E       TML Pascal source code
$B0  $0116       ORCA/Disassembler script    Application Specific
$B0  $0503       SDE Assembler source code   Application Specific
$B0  $0719       Postscript file             Application Specific
$B1*        OBJ  Apple IIGS object code
$B2*        LIB  Apple IIGS Library file
$B3*        S16  GS/OS application                                      09/89
$B4*        RTL  GS/OS Run-Time Library
$B5*        EXE  GS/OS Shell application                                09/89
$B6*        PIF  Permanent initialization    Not loaded if bit 15 set***09/90
                 file
$B7*        TIF  Temporary initialization    Not loaded if bit 15 set***09/90
                 file
$B8*        NDA  New desk accessory          Not loaded if bit 15 set***09/90
$B9*        CDA  Classic desk accessory      Not loaded if bit 15 set***09/90
$BA*        TOL  Tool                                                ***09/90
$BB*        DVR  Apple IIGS Device Driver    Not loaded if bit 15 set   11/89
                 File
$BC*        LDF  Load file (generic)                                    07/90
$BD*        FST  GS/OS File System           Not loaded if bit 15 set***09/90
                 Translator
$BF+        DOC  GS/OS document
$C0*        PNT  Packed Super Hi-Res         Application Specific
                 picture
$C0+ $0000       Paintworks Packed picture   Application Specific       11/88
$C0+ $0001       Packed Super Hi-Res Image   Application Specific       11/88
$C0+ $0002       Apple Preferred Format      Application Specific    *R*09/90
                 picture
$C0+ $0003       Packed QuickDraw II PICT    Application Specific       11/88
                 file
$C1*        PIC  Super Hi-Res picture        Application Specific       11/88
$C1+ $0000       Super Hi-Res Screen image   Application Specific       11/88
$C1+ $0001       QuickDraw PICT file         Application Specific       11/88
$C1  $0002       Super Hi-Res 3200 color                             ***09/90
                 screen image
$C2+        ANI  Paintworks animation
$C3+        PAL  Paintworks palette
$C5*        OOG  Object-oriented graphics    Application Specific
$C5+ $8000       Draw Plus document          Application Specific
$C5+ $C000       DYOH: Architecture          Application Specific
                 document
$C5+ $C001       DYOH predrawn objects       Application Specific
$C5+ $C002       DYOH custom objects         Application Specific
$C5+ $C003       DYOH clipboard              Application Specific
$C5+ $C006       DYOH: Landscape Document    Application Specific
$C6         SCR  Script                      Application Specific
$C7*        CDV  Control Panel document      Not loaded if bit 15 set*R*09/90
$C8*        FON  Font
$C8  $0000       Font (Standard Apple IIGS   Reserved                   01/89
                 QuickDraw II Font)
$C9*        FND  Finder data
$CA*        ICN  Icons                                                  07/89
$D5*        MUS  Music sequence              Application Specific       01/90
$D5+ $0000       Music Construction Set      Application Specific
                 song
$D5  $0007       SoundSmith document         Application Specific       03/90
$D5+ $8002       Diversi-Tune sequence       Application Specific
$D5  $8003       Master Tracks Jr. sequence  Application Specific
$D6*        INS  Instrument                  Application Specific       01/90
$D6+ $0000       Music Construction Set      Application Specific
                 inst.
$D6+ $8002       Diversi-Tune instrument     Application Specific
$D7*        MDI  MIDI data                                              01/90
$D7+ $0000       MIDI standard data          Application Specific
$D8*        SND  Sampled sound               Application Specific       01/90
$D8+ $0000       Audio IFF document          Application Specific       03/89
$D8+ $0002       ASIF instrument             Application Specific       03/89
$D8  $0003       Sampled Sound resource      Application Specific
$D8+ $8001       HyperStudio sound           Application Specific       05/90
$DB*        DBM  DB Master document          Application Specific
$DB+ $0001       DB Master document          Application Specific
$E0*        LBR  Archival library            Application Specific
$E0+ $0000       ALU library                 Carolina System Software
$E0  $0001       AppleSingle File            Application Specific       03/90
$E0  $0002       AppleDouble Header File     Application Specific       03/90
$E0  $0003       AppleDouble Data File       Application Specific       03/90
$E0  $8000       Binary II File              Application Specific       07/89
$E0+ $8001       AppleLink ACU document      Application Specific
$E0+ $8002       ShrinkIt (NuFX) document    Application Specific       07/90
$E0  $8004       Davex archived volume                                  05/90
$E0  $8006       EZ Backup Saveset document                          ***09/90
$E2*        ATK  AppleTalk data
$EE         R16  EDASM 816 relocatable file
$EF+        PAS  Pascal area
$F0+        CMD  BASIC command
$F1*             User #1
$F2*             User #2
$F3*             User #3
$F4*             User #4
$F5*             User #5
$F6*             User #6
$F7*             User #7
$F8*             User #8
$F9*        OS   GS/OS System file
$FA+        INT  Integer BASIC program
$FB+        IVR  Integer BASIC variables
$FC*        BAS  AppleSoft BASIC program
$FD*        VAR  AppleSoft BASIC variables
$FE+        REL  Relocatable code
$FF*        SYS  ProDOS 8 application

_____________________________________________________________________________